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1.0 INTRODUCTION 





This manual is designed to be used in conjunction with existing 
Assembler H documentation. It describes the HASH command, and 
contains information on the features unigue to the Assembler 
H/CMHS Interface program. 


The HASM command as described herein is used to invoke Assembler 
H under control of the Conversational Monitor System (CMS), a 
component of ITEM Virtual Machine Facility/370 (VM/370). ‘dhe HASM 
command thus makes availabie, to the CMS user, the extensions to 
assembier language and improved assembly performance providea by 
Assenbler H relative to preceding CMS assemblers. 


This w#anual also contains the inforration needed by) sysitem 
support personnel to install, maintain, and modify the Assembler 
/CuS Interface prograa. 


2-0 SYSTES OVERVIEW 


In order to install Assembler H for use in a CMS environment, the 
user must have both the Assembler H/CHS Interface IUP 
distribution tape and the Assembler H Program Product (PP) 
distribution tape. The programs and CHS exec procedures 
distributed as part of the IUP make possible the installation and 
execution of Assembler H under the control of CAS. 


During the installation process, the files from the IUP tape and 
the object modules, macro definitions and sample program from the 
PP tape are loaded. A CHS exec procedure is then used to 
generate the CHS sodules needed to execute the asseabler. 


After installation of Assembler H has been completed, the HASH 
command. can be used to invoke Assembler H to assemble user 
specified files. Asseabler processing and output are conatrolled 
by the options specified in the HASH command. | —_ 





Throughout the remainder of this manual, the following teras will 
be used: 


e UP refers to all programs and files that are provided as 
part of the Assembler H/CHS Interface Installed User Program 
distribution saterial, Program No. 5796-—PEJ. 


# PP refers to all programs and files that are provided as part 
of the OS Assembler H Program Product distribution material, 
Program No. 5734-AS1 (basic material only). 


« HASM, unless otherwise qualified, refers to all programs and 
fides that collectively provide the ability to install and 
execute Assembler H under CHS... 


Ze3 SYSTEM CONFIGURATION 


The minimum system contiguration requirements tor installation of 
HASH are Ssatistied by the 7N/37G miniwum configuration. ‘he 
miniamtim requiresents for subsequent use of HASA are Satistied by 
the CHS minimum contiguration. kefer to the publication iBM 
Virtual fAachine Facility/370: Planning and System Generation 
Guide, Order No. GC20-1801, for details. 


2.4% EROGHKAMHING SYSTEMS 


An operational V4/37G system serves as the base for TASMN 

instailation and subsequent use. In addition, the user must have 

availabie the IUP tape ana the PP tape. The tollowing is a list 

of the IBM prograws reguired to install, operate and/or maintain 

HASS ¢ 

e Virtual Machine Facility/370, Program No. 5749-U10, Release 
2, Modification Level 0 (an operational CMS system is 
required by this IUP) 


& OS Assembler H PP, Program No. 5734-AS1, Version 5 (only the 
basic distribution material is required) 


e Assembler H/CAS Interface IUP, Program No. 5796-PEJ 





3.0 FROGKAM DESCHIPTIONS 


fne programs which are part of HASM are of two general types: 
those usea during the installation process and those used during 
an aSsembly initiated by the HASH command. The purpose of each 
tile ioaded or created during the installation process is 
described in Section 4, Installation Instructions. The EASM 
command, and all files processed or created by it, is descriped 
in Section 5, Operations Instructions. 


The Assembler H/CMS Interface IUP 1S composed of a number of CAS 
exec procedureS and programs. The programs are written in 
assembler language and in some cases use language features 
availabie with Assembler ke. The CMS exec procedure EHASMLOAD and 
the program HASMLOAD are used to load the Assembier H tape. The 
C45 exec procedures HASAGEND and HASMGMOD, and the programs 
HASMNOPCO, ITEV61, IEVCHS, and LEVAUX are needed for generation of 
the assembler modules. HASHOPCG, IEV61, and IEVAUX do not 
contain executable code. This section describes the way in which 
the IUP establishes the interface between Assembler H and CMS. 
the information given is antended to be used in conjunction with 
listings ot the CHS exec procedures and programs. 


3.1 USt OF THE ASSEMSLER BE DISTRIBUTION TAPE 


te Eee Gnesi eiiizemies 


The loading of the Assembler H distribution tape is done using 
the EASHLOAD EXEC. ‘The EZEC first determines that IEV61 TEXT 
does not exist on any currently accessed disk. Tnis is necessary 
So thet the anitial generation of the assembler modules will be 
correct. Next, a FILEDEF command 1s issued for TAP (virtual 
tape address 161) using ddname IEVIN. This ddname is used by the 
HASHLOAD program to read the Assembler H PID tape. The HASSLOAD 
program (Which exists as HASMLOAD TEXT) is then invoked by the 
BAEC. 


The KASMLOAD program is used to load the Assembler H object 
modules, macro library, and sample program from the PID tape. 
Correct operation of the program requires that the tape be 
Stractured in a ‘particular way. The Assembler H Wersion 5 PID 
tape served as the basis for the design of HASMHLOAD, and correct 
Operation with tapes containing earlier versions was not 
investigated. Successitul operation of the program writes the 
following tales on the A-disk: IEV10 TEXT, IEV2ZO TEXT, IFVSO 
Text, LEVYOQ TEXT, IEV5GO TEXT, IEV60 TEXT, LEVOO TEXT, HASNMAC 
COPY, IEV5G1 TEXT, IEVWV5SO2 TEXT, YEV503 TEXT, and IEVSANP 
ASS BABLE. 





After execution ot the HASSLOAL proqram, the HASMLOAD EXEC copies 
TEV50 TEXT as JTEV500 TEX: (IfEV500 TEXT is the Assemblr H object 
module for t:pe universal instruction set). The other 1EVnn TEXT 
files are placed in HASNGLIL TXTLIB and the TEXT files are 
erased. The HASSMAC COPY file is placed in EASMMAC MACLIB and 
the cCorY file is erased. 


HASSLOAL KKAEC next invokes the HASMGEND EXEC uSing the INSTALL 
option. This results in the generation of a usable set of 
assembler modules for use in the next phase of the installation. 
Upon return from HASMGEND, control is returned to C&S. 


3eZ GENEKATION OF THE HASM MODULE FILES 





The HASMGEND EX#£C is used to generate the Asseabier H/CMS 
intertace routine HASH MODULE as well as the assembler modules 
theaselves. in the process of doing this, a number ot assemblies 
will be done. During a full re-generation, the tollowing steps 
are performed by HASMGEND: 


1. Flaces the uSer created file BASMHOPT COPY (described in 
Section 4%) in HASMOPT MACLIB. Issues the command GLOBAL 
TXTLIB HASHGLIB (contains Assembler H object modules). 
issues the command GLOBAL MSACLIB KEHASMMAC HASMOPT CMSLIB 
OSHACKO (specifies macro libraries needed for assemblies). 


ze Assembles the fiie IEV61. This assembly produces 1EV61 TEXT 
and is the Assembler H module which contains default options 
and ddnamwes to be used by the assembler. IEV6O1 TEXT becomes 
part ot IEV66 KODULE. 


3. issues a STATE command to see if IEVSOLOP TEAT exists on any 
accessed disk. I1f so, this file will be used as the op-code 
table when generating IEV50 MODULE. This step provides a 
means for an installation to include its own local op-code 
table rather than one of those supplied as part of the 
Assembler H Program Product. | 


4. If IEV5GLOP TEXT does not exist, the fiite HASMOPCO is 
assembled. This is aqone only to determine which instruction 
set was selected by the installation, and results in a 
returm code between 250 and 253. inclusive. Atter 
subtracting a constant 250 from this return code, a single 
digit fro# 0 to 3 results. This digit is concatenated to 
the name IZV5G, storming, for example, IEV500. This 
procédure determines the filename of the TEXT tile that will 
be used as the op-code table. 


10. 


11. 


Assembles the files IBVCMHS and IEVAUX to aoe the TEXT 
tiles and listings. 


Using IEVCMS TEXT and IEVAUX TEXT, genmod IEVHA MODULE. 
This module will be re-generated later and given the name 


KASM MODULE. It is generated at this time because it is 


needed in generating a correct assembler module ‘overlay® 
type structure. 


Using the sub-exec HASMGMOD, the following files, alli with 
fiietype SODULE, are generated: IEV00, IEV10, IEV20, IEV50, 
TEV60, ITEVSO0, and IEVSU. These sodules form a prestructured 
overlay that conforas to that depicted in "Figure 2. Main 
Storage Usage’, in the publication OS Assembler H Logic, 
Order No. LYZ6-3760. The methods used in creating such an 
overlay structure are described in the section entitied 
‘Overlay Structures* in the publication IBM Virtual Machine 
Facility/370: System Programmer ®s Guide, Order No. 
GC20-1807. Notice that the modules are generated in a 
‘bottom up® manner and then generated again in a ‘top down® 
manner. This is done so that a given MODULE will havea 
module sap containing only its own symbois. All of the 
modules have module &aps at this point so that the CMS ZAP 
command cam be used, if desired, to refer to external naunes 
contained in the moduies. 


Using IEVCHS TEXT and IEVAUX TEXT, after prompting for the 
mode letter to be used in a GENDIRT command, HASM MODULE A2 
is created. 


The file HASMHGEN MAP is created from the MAP files created 
by HASSGMOD EXEC during module generation. The extra MAP 
tiles are then erased. 


T£ the ZAP option was specified in the HASAGEND command, a 
ZAP command will be issued specifying that file ‘*HASMZAP 
ZAP*® contains ZAP command input. This provides a method of 
applying Assembler H PTF fixes distributed as input to the 
OS service routine IMASPZAP. 


It the SAP option was specified in the HASSGEND command, 
control is returned to CHS at this point. Othervise, the 
assenbler modules will be LOADMODed and GENMODed once again, 
this time specifying the WOMAP option in the GENNOD 
commands. Control is then returned to CHS. 


3.3 EXECUTION LOGIC 


For a description of the execution logic ot the HASS command 
processor, system sujport personnel should consult the source 
listing for moduie iEVCMS (produced by HASMGEND EXk&C). This 
listing, which is heavily commented, is prefaced by a description 
of the overall operation of the module. For information 
describing the execution logic of the Assembler H_ Program 
Prodact, refer to the publication OS Assembler kh Lojic, Order No. 
LY26-3760. Program listings for Assembler H modules tay be 
obtained on microfiche using Order No. LCk6-3772. 





4.0 INSTALLATION iNSTRUCTIONS 


TAPE 





4.1 UP DISTRIBUTION 


The LUP distribution tape, in the recording density and format 
requested by the recipient, contains one file in CHS TAPE DUMP 
format. The CSS files contained on this tape are those necessary 
to process the PP tape in a CMS (rather than OS) environment at 
installation time, and to interface the assembler with CMS at 
execution time. 


4&2 INSTALLATION VIRTUAL MACHINE 








In addition to a correctly operating ¥8/370 systeuw, HASA requires 
the following for installation: 


ae A wirtual machine with storage size of at least 396K 
with CMS availabie. 


be. A CMS formatted pinidisk with at least ten available 
cylinders of 3330 disk space (or equivalent) to serve as 
the installation disk. This same minidisk can be used 
for future maintainence and/or modification activity. 


The installation process creates a number of CMS files of 
tiletype MODULE. These MODULE files make up the s#inimun set of 
files that must be available at assembly time for correct 
operation of the HASH command. If ait is decided to copy these 
modules to another minidisk after installation is complete, 
approximately one cylinder of 3330 disk space (or equivalent) is 
reg uired. | 


4.3 LOSDING THE IUP DISTRABUTION TAPE 


Ge 


Kount the IUP distribution tape (5796-PkJ) on a_ tape 
unit and ATTACH that unit to the virtual machine using 
wirtual address 1. The installation disx should be 
ACCESSed as the A-disk in read/write wmode. 

Issue the CHS omaand TAPE 1OAD. Upon successful 
completion of this command, the following iiles will 
have been loaded on the installation disk: 


HASMLUAD ASSEMBLE —- Source code and opvjyeci text tor the 


HASNLOAD TEX¢ program used to process the PP tape 
AEVAUX ASSEMBLE ~ source code and object text fur the 
LEVAUXZ TEXT HASM auxiliary directory 

TEVCHS ASSEMBLE - Source code and object text tor the 
LEYCMS TEX? pea command processor 


HASSOPCO ASSESELE - asseabled during installation to 
: acer instruction set 

IEV61 ASSENHELtz ~- assembled during installation to 
include specified deiault options 

HASSOPT COPY ~- — - Contains macro ainstructions which 
specify default options and values 

HASMGEND EXEC — — — builds (rebuilds) all .AS*4 wsaodules 

HASNGSOD EXEC - -—- - Sub-ewec used Dy HASNGEND 

BASMLOAD &£XEC ~- - - controls processing 01 tne Pk tape 

KASMSEP MAP -—- — = ased in construction or EASMGtN AAP 


The 1UP tape may now be rewound and unloaded. 


4.4 LOADING THE PP DISTKIBUTION TAPE 





ae Mount the PP distribution tape (5734-AS1) on a tape unit 
attached as virtual address 181 (if the tape unit from 
the previous step is used, ensure that the recording 
density of the PP tape is compatible with the tape unit 
in use). 


b. Issue the CMS command HASMLOAD. Upon. successful 
completion of this EXEC procedure, the following files 
will exist in addition to those listed previously: 


HASMHAC MACLIB - - PP macro definitions 
KASHGLIB TXTLIB -—- —- PP object sodules 

LEV500 TEXT —- -— ~ PP universal opcode table 
LEV50O1 TEXT - —- — PP scientific opcode table 
ITEV502 TEX? - —- -— PP commercial opcode table 
LEV503 TEXY - ~- ~ PP standard opcode tabie 
IEVSASP ASSEABLE — PP sample program 

Tev50 TEXi ~ —- ~ HASH opcode table installed 


HK ASM HODULE ~- ~- HASH command module 

IEVOO MODULE ~- — HASM assembler srodule 
IEV10 MODULE - - HASM assermbler sodule 
LEW20 MODULE ~ ~ KASK assesbler module 
IEV50 MODULE — — HASM assembler saodule 


1EV60 HODULE ~- ~- HASM assembler module 
ITEV8 0 MODULE ~ ~ KASM assembler module 
ITEVS9O SODULE ~- ~ HASM assesbler rsodule 
HASHGEN MAP - ~- ~ HASH module map 


It should be nota that in addition to loading certain 
modules from the PP tape, HASMHLOAD EXEC also invokes the 
HASMGEND EXEC to build a working HASM processor. This 
is necessary tor subsequent installation processing. 


c. The tape unit attached as virtual device 181 may now be 
DETACHed. | 


4.5 ESTALLISHING INSTALLATION DEFAULT OPTIONS 








At this point in the installation process, all necessary files 
have been loaded from the i10P and PP tapes and a working HASH 
processor has been generated. You may now specity, if desired, 
new Walues for any assembler default option or ddnare. You may 
also select any one of the available instruction sets (standard, 
scientific, commercial, or universal). 


Yo specify the desired values, you use macro calls. One of the 
files ioaded on the installation disk was HASMOPT COPY. This 
file, as distributed, contains one macro cail and specifies 
NODFCK and OBJECT as assembler default options. As distributed, 
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HASMOPT CGPY contains the tollowing: 
OPTIONS DEP AULT= WODECK, OBJECT) 


it is suggested that at least these two default options always be 
specified during instailation so that object moduies created by 
EASM commands will be handied as expected. 


The CKhS editor can be used to change the OPTIONS macro supplied, 
and to create additional wacro calls in the HASNOPT COPY file. 
Tne macros that are valid are OPTIONS, DDNAMES, ana OFCODES. The 
functions pertormed by each of these macros and the operands used 
With each are fully cescribed in the publication OS Assembler H 
System Intormation, Order No. SC26-3706, under the heading 
‘instailation Procedure - Phase One*. Only the tnree sacros 
named above should be coded in HASMOPT COPY. The GENPARA macro 
and the END statement described in the referenced publication 
have already been supplied elsewhere and need not be supplied by 
the user. 


4.6 TRE HASSGEND EXEC 








The HASMGEND EXEC is used to generate all HASM modules. the exec 
recognizes three user supplied parameters. They are MAL, ZAP, 
and KEDIRT. The MAP and ZAP parameters are aescribed in this 
Section. The REDIRT parameter is described in the tollowinng 
section. 


a. The MAP parameter specifies that the HASM modules 
generated are to have CMS module mups. It this 
parameter is not specified, the MODULE riles will be 
GENNODed using the NOMAP option. 


b. The ZAP parameter Specifies that a tiie named ASAZAP 
ZAP, containing CHS ZAP command control statements, is 
to be applied against the HAS" modules duriny the 
generation process. In conjunction With the tile 
HASMGEN MAP, described in the next section, this 
parameter ftacilitates the application ot OS SUPERKZAP PTF 
fixes to the assembler nodules. the CMS ZAP command is 
describea in the pubiication IBM Virtual Machine 
Facility/370: System Programmer's Guide, Order No. 
GC20- 1607. 
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4.7 FINAL STEPS IN THE INSTALLATION PROCEDURE 











The KASSGEND EXEC ais used to cosplete the installation 
procedure. It generates all HASH modules, and aiso produces a 
file named HASSGEN MAP which lists all module entry point names 
and their associated storage addresses. 


a. issue the CNS command HASSGEND, also specifying the MAP 

7 andfor ZAP parameters if desired. Upon successful 
completion of this EXEC procedure, the following files 
will exist on the installation disk in addition to those 
listed previously ; 


HASMOFT MACLIB — -— contains HASSMOPT copy file 
LEV61 TEXT —- - ~- contains Assembler H defaults 


in addition, three assembly listings will be printed 
offline. These listings are of modules ILIEV61, IEVCMS, 
and IEVAUX. 


Se buring execution of HASMGEND, the following questions 
are asked: 


DO YOU WISH TO USE AN AUXILIARY DIKECTORY (RESPOND YES 
OR NO) 


A response of NO will cause the assembler modules to be 
given a ftilemode of ‘"A2* after they they have been 
generated. A response of YES will cause the filemode to 
be "Al*® and will also cause the following question to be 
aske ds | 


ENTER THE MODE LEPTER THAT WILL BE USED TO ACCESS TEE 
DISK CONTAINING THE H-ASSEMBLER MODULIS, O88 ENTER A NULL 
LINE TO DEFAULT THE MODE LETTER TO °S* 


The mode ietter entered is used in a CHS GENDIRT command 
during the generation of HASH #AODULE. Reter to the 
publication iBM Virtual Machine Facility/3s70: System 
Programmer*s Guide, Order No. GC20—1607, under the 
heading “AUXILIARY DIRECTORIES*, for a discussion of 
this subject. 
Unless you desire to copy the HASS modules to another minidisk, 
the installation is complete. If you do wish to make HASM 
available on another minidisk, you need copy only the following 
KODULE files: . 


oa Vem 


KASS MODULE 
TEVOG MODULE 
itV1iG MOLULE 
ILEV2Z2G MODULE 
TEV5UG MODULE 
4iVoG MOLGULE 
TEVGBU MOUULE 
TEVSt MODULE 


Also, if these modules are copied to another minidisk, you shoulda 
be aware that HAS MODULE may need to be re-GENDIRied (untess you 
are not wuSing an auxiliary directory). This operation 41s 
tacilitated by the cosmanu HASNGEND REDIRT. VYhe KEvIb? parameter 
indicates that BASS 4OLDULE is to be regenerateu. Ir RrbdIkr as 
specified, the 4AF parameter should not be specified and the MAP 
parameter may be specitied if desired. For exampice, assume that 
it is desired to instail the #WASM modules on the CxHs system disk. 
Assume also that the system disk and HAS# installution dask have 
Virtual addresses 19G and 250 respectively, and that 1490 is 
linked in read/write mode. The toliowing sequence of commands 
might be used to accomplish the desired results: 


ACCESS 190 A 

ACCESS 250 b/B 

COPY PILE * MODULE B = = A (OLDD TYPE 
HASNGEND REDIRT 


Tne COPYFILE command is used to copy the eight sSOUUL: tiles to 
the A-disk (190). The BASMGEND command, specitying the REDIRT 
parameter, will type the message FNTRR THE MOLE LeiTik ThAT wILL 
BE USED..-, and will then GENDIRT and GENMOU Only HASM MODULE. 
The other seven modules remain unchanged. 


4€ you responded NO to the bO YOU WISH TO USE AN AUKILIAKY 
DIKECIORY question previously described, then you snould NOT 
issue the HASMSGEND wEDIkT command. You they stup after the 
COPYFILE command an the above example. 


4.6 S8ODULF KEGENCRATION CONSTDERA TIONS 


Shoulda it becume necessary to regenerate the &hAS% modules, this 
can normaily be accompiishei without recourse to the installation 
tapes af the fiies created during initial installation are 
aVdliabie. To change an assembler option, for exanple, you could 
ACCESS the instaliation disk as the read/write A-Gisk, LILI the 
Change anto HASMOPT COPY, and issue the commund HASAGEKUD. ‘the 
fame cenerael procedure cCah be used to incorporate local proyram 
modifications. The <iniormation contained in the section 'Final 
Steps in the Installation Procedure will, ibn venerei, remain 
applicable. 


4G 


SUSMARY OP STEPS TO INSTALL HASM 


Je 


Ke 





Access the instailation disk as the read/write A-disk 
Attach a suitable tape drive as virtual address 781 
Mount the IUP tape on virtual unit 161 

issue the CHS command: TAPE LOAD 


issue the CMS command: TAPE RUN 


Mount the Assembler 4 PP tape on virtual unit 181 


Issue the CSS command: HASMLOAD 
Issue the CP command: DETACH 781 


If desired, EDIT the file HASMOPT COPY to _ specify 
installation detaults 


Issue the CMS Command: HASMGEND 


If desired, copy the HASH awodules to another minidisk 


~Fu=— 


5.0 OPEKATIONS INSTHUCTIONS 


51 KEFERENCE DOCUMENTATION 





The HASA command is used in basically the same way as the CMS 
ASS ESELE command. Some command options are ditferent, relfecting 
differences between the Ws8/370 assembler and Assembier dH. As 
mentioned in the introduction, this manuai iS intended to be used 
in conjunction With existing Assembler H documentation. These 
manuals, in turn, are intended to be used in conjunction with 
existing OS/VS-DOS/VS-¥4/570 Assembler documentation. Por your 
convenience, a iil1ist of these manuals, along with their order 
numbers, 1S given below. 


* OS/VS, DOS/VS, and VH/370 Asseabler Language, GC33-4010 


e OS/VS and W4/370 Assembler Frogrammer®s Guide, G6C33-—4021 


@ i&M Virtual Machine Pacility/370: Command Language Guide for 
Generai Users, GC2Z6—1504 


& OS assembler H General Information Manual, GC26-375t 
. OS Assembler HK Languaye, GC26-3771 
« OS éssembler H Programmer's Guide, SC26-3759 


« OS Asseuwbler H Messages, SCZ6-3770 
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5-2 EASM COMMAND 





5.221 COMMAND OPTIONS 


HASA offers a number ot optional facilities. For example, you 
cah suppress printing of your assenbly listing or parts of the 
disting, and you can specify whether you want an object deck or 
an object sodule. You select the options by including 
appropriate keywordS in the HASM command that invokes’ the 
asSembier. There are three types of options: 


¢ Simple pairs oi keywords: a positive form (such as OBJECT) 
that requests a facility, and an alternative negative form 
(such as NOOBJECT) that rejects that facility. 


e Keywords that permit you to assign a value toa function 
(such aS LEINECOUN (50) ). 


. HASM comand processor options (such as PRINT) which are not 
passed to Assembler H but are used to control certain aspects 
of the assembiy process. Such opticns are referred to in 
later sections as "CMS options", to distinguish them from 
Agsembier H options. 


Bach ot these options has a standard or default value which is 
used tor the assembly if you do not specify an alternative vaiue. 
The detault vwaiues are discussed in the tollowiny section, 
"Command beruults®. 


The HASH command processor combines all the assembler options 
into a strang oi Characters With a comma separatiny each option. 
This string 1S passed to tne assembler when it is invoked. If 
"1® options are specified (n>1), then "n-1 commas are inserted. 
The total number of Characters in the assembler options plus the 
number of inserted Commas must not be greater than 100. The CMS 
options are not included in this count. You may specify the 
Options im aby order. YF contradictory options are used (tor 
example, LIST and NOLIST), the rightmost option (in this case, 
NOLIST) is used. 


The command options ace described in section 5.2.3 
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Se2ZeZ COMMAND DEFAULTS 


If you do not code a given option in the HASM command, a default 
option will be assusazed. The following default options are 
included when HASS is shipped by ISMN: 


NODECK, OBJECT, LIST, XREF (FULL), NORENT, NOTEST, NOBATCH, ALIGN, 
ESD, RLD, LINECOUN (55), FLAG(0), SYSPARM(), DISK, NUMBER, NOSTMT, 
TERMINAL (0) 


Howewer, these may not be the default options in effect at your 
instailation. The defaults could have been respecified when HASM 
waS installed. For exampie, RENT could be made the default in 
place of NOKENT. Also, a default option can be specified during 
installation so _ that you cannot override it. Similar 
considerations apply to the assembler ddnames tor which the EAS 
command processor issues FILEDEFs. In the description of the 
KASS command, the options and ddnames specitied as being “default 
walues" are those included when HASM is shipped by IBM. 


You should determine what default values are in effect at your 
installation and whether there are any you cannot override. 
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5.203 COMMAND FORMAT 


The HASS Command is used to inwoke Assembler H to assemble the 
specified file. HASH processing and output are controlled by the 
options selected. The format of the HASM command follows. 
Default vwaiues are underscored. 











i ! | d 
} HASH i ({fin] [ (options...[)]] ( 
} ! i 
: i Listing control options: i 
I | i 
{ lor. 1 fF + 3% fF 4 { 
jo { { ESD { {FLAG (0) { {LIST | ILINECOUN (55) | { 
| i |NOESD | IFLAG (nn) | {JNOLIST | {LINECOUR (nn) j j 
| i é. =} i oj i. - | a a } 
i ( i 
{ ior 7 fr : ; ee 1 i 
| t { KRLD [ {XKREF (FULL) [ {DISK i 
{ { [NORLD ] {XREF (SHORT) | {PRINT {[ é 
i | au & | NOXEREF i {VOPR INT} f 
i | L - ‘i | { 
i [ ; { 
i | object podule control options: { 
! I | 
i i or oe or * 7 i 
! { [DECK [| [OBJECT | {TEST |{ { 
| { NODECK | INOOBJECT{  {ROTEST | i 
j j u | & af hi. m | { 
{ i | i 
{ { SYSTERN options: i 
| ! i 
{ i or ” 1 7 [ 
{ {| {NUSBEKR [{ ISINT | [ZERWINAL (0) | [ 
| [NONUSBER[ {| NOSTST| (|TERAINAL (n) | i 
| | a. J a = | NOT ERB l | 
| i # ( 
i i i 
; | other options: [ 
i t i 
i l or 2 OF % oF % fr 1 | 
| | {ALIGN | {BATCH ¢ |[RENT [| {SYSPARN () | 
| ([NOALIGN[ [MOBATCR] {NORENT{ (|ISYSPAKM (string)| | 
| } a. A i. A a. | 4 ISYSPARS (7?) } i 
i l 4 
Baie anche sie ecard ss 


| 
| 
| 
L 
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fn -- ais the filename ot ine source file to be assembled. The 
file specified must consist of fixed-length, o character 
records. lf a user issued FILEDEFP for SYSIn is active, and 
if the fFILELDEF specitied DISK, the filename may pe omitted. 
If the user FILELDEF specified TAPn or REAVEK, a "duumy" 
tilename must be supplied and is used to nawe the TEXT and 
LISTING fales. it no user FPILEDEF for SYSIN is active, the 
source file must exist on an ACCESSed disk and must have a 
tiletype of ASSEabLE. 


ESD ~- The assembler proauces the External Symboi Dictionary as 
part of tne Listing. 


FLAG (nnn) -~- Error diagnostic messages below severity code nnn 
wiil not appear in the listing nor on the SYSTEKS device. 
biagnostic messageS can have severity codes oi VU, 4, 8&8, 12, 
io, or 20 (08 is the least severe). MNOTES can have a 
severity code ot 0 through 255. 


For exampie, FLAG(&) will suppress messages for severity 
codes 0 through 7. 


LIST -- An asSembler listing is produced. Note that the NOLIST 
option overrides the £:SD, RLD, XKEP, DISA, and PHINT 
options. In addition, no diagnostic information will be 
written on tue SYSTEKM device. 


LINECOUN(nn) -— The number of lines to be printed between 
headings in the i1Sting is the number npn. The permissible 
range is 1 to 99 Lines. 


KkKLD -- The azssembler produces the Relocation Dictionary as part 
ot the listing. 


XREF(FULL) -- The asSembier listing Will contain a cross 
reterence table ot all symbols used in the assembly. ‘This 
includes symbols that are cefined but never referenced. 
The assembier listing will aisc contain a cross reterence 
table ot iiterals used in the assembly. 


AREF (SHOKT) -— fhe assembler listing wili contain a cross 
reference tapdle of all symbols that are reterenced in the 
asseubly. Any Syubois aefined but not referenced are not 
anciuded in the tabie. The assembler Listing will also 
contain a cross reference table of literals used in the 
assembly. 
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PRINT [| PR -- This CMS option writes the LISTING tile on the 
printer. The LISTING file is not written on disk. 


NOPRINKT | NOPK -- This C&S option suppresses the writing of the 
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LISTING file. Any assembler diagnostic messages will still 
be written on the SYSTERA device. 


DECK -- The object module is placed on the SYSPUNCEh device. 
ObJECY — The object module is placed on the SYSLIN device. 


Note: The OJJ#CTF and DECK options are independent of each other. 
Both Or neither can be specified. The output on SYSLIN and 
SYSPUNCH ais identical except that SYSLIN is closed with a 
disposition of LEAVE and S¥SPUNCH is closed with a disposition of 
REREAD. 
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TEST -- The object module contains the special source symbol 
table (S¥M cards). 


NUMGER | NUM -~ This CMS option writes the line number field 
(columns 73-80 oi the input records) on the SYSTERM device 
for statements for which diagnostic information is 
produced. 


NOWUMAER | NOnOM -~- This CHS option suppresses the NUNSEER 
option. 


SIN? -- This CAS option writes the statement number assigned by 
the assembler on tne SYSTERM device for those statements 
for which diagnostic information is produced. 


NOSTAT -- This CNS option suppresses the STMT option. 


TERMINAL(n) | TERM(n) -- This CMS option provides the ability to 
Stop diagnostic information of a given severity from being 
written on the SYSTERM device. The value of n is a@ decimal 
number between OG and 7. The walue of n can be thought of 
aS a 3 bit binary number, and it is this 3 bit “mask™ that 
serves aS the diagnostic message filter. Consider the 3 
bits to be labeled b0, b1, b2 from left to right. Then, 
the following apply: 


bO = 1 #£=xSuppress *FRROR® diagnostics 
b1= 1 suppress "*WARNING® diagnostics 
b2= 1 #4suppress ‘MNOTE® diagnostics 


For example, TERK (4) will SIpPe ees) ERROKS, and TERM(5) will 
SuppreSs ERRO#S and ANOT Es. 


NOT#E® -- This CHS option suppresses the writing of all 
diagnostic information on the SYSTERM dewice. NOTERM has 
the same effect as the option TERMINAL (7). 


ALIGN -— Tne assembier does not suppress the alignment error 
diagnostic message. All alignment errors are diagnosed. 


NOALIGN -- The assembler suppresses the diagnostic message 


== 


M7 EVOS53 ALIGNMENT EKROR® if fixed point, tloating-point, or 
logical data referenced by an instruction operand is not 
aligned on the proper boundary. The messaye will be 
producea, however, tor references to instructions that are 
not aligned on the proper (halfword) boundary or tor aata 
boundary violations for privileged instructions such as 
LPS®. DC, BS, bab, or CxkXb constants, usually causing 
alignment, are not aligned. 


BATCH -- The assembler will do multiple (batch) assemblies under 
tne control of a single HASM command. fhe source decks 
must be placed together in one file. Tne TEXT title 
produced will contain multizle object decks. The LISTING 
tile prodaucea wiil contain multiple listings. 


KENT -- The assembler checks for possible coding violations of 
program reenterability. 


SYSPARKM (String) -- "string" is the value of the system variable 
symbol &SYSPARA. The assembler uses 6&SYSPARKM as oa 
read-only S&tTC wariable. If no value is specified tor the 
SYSPAKM option, &S¥YSPARM will be a null (empty) character 
string. 


in the CMS environment, "string® cannot be longer than & 
Characters. If you wish to enter a string of more that 8 
Characters, use the SYSPARMN(?) format. Using this forn, 
you wiil be prompted at your terminal with the message: 


ENTER SYSPARN : 


A terminal read iS than assued so that the SYSPAR™ value 
Can be entered. It is also necessary to use the SYSPAR4 (7?) 
form to enter parentheses and/or imbedded blanks in 
‘string*. 


52-4 COMMAND DLAGNOSTIC MESSAGES 


For information on the diagnostic messages output by Assembler H, 
refer to the pubiication OS 4ssembler H Messages, Order No. 
SC26—23770. In addition to the messages which may be issued py 
the assembler, there are messages which may be isSued darectly by 
the FASM command processor. The following is a list ot the 
message codes, message texts, and return codes which may occur. 


TEVCHSUWE FPILENANE OSITTED AND DDNAMBE "SYSIN® IS 
| UNDEFINED. (re = 24) 
LEVCASO ITE FILERAHE OMITTED AND FILEDEF ‘SYS1N° IS 
NOT FOK DISK. (rc = 24) 
TEVCMSOO2ZE FELE "tn tt im® NOT FOUND. (re = 28) 
LEVCMSO03F INVALID OPTIGN *option*. (rc = 24) 
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Tev CHS 0O04E IMPROPERLY FORMED OPTION *option*. (re = 24) 
TEVCMSOO6E NO READ/WRETE DISK ACCESSED. (re = 36) 
IEVCHSOOTJE FILE ‘tn ft tm* DOES NOT CONTAIN FIXED 

LENGTH 80 CHARACTER RECORDS. (rc = 32) 
LeVCHSO38K FILEID CONFLICT FOK DDNAME "SYSIN*. (rc = 40) 
LEVCHSO52E OPTIONS SPECIFIED EXCEED 100 
| CHARACTERS. (cc = 24) 
TZVCMSG70E iNVALID FARASETER ‘para*. (rc = 24) 
IEVCSSO7SE DEVICE ‘device* INVALID FOR INPUT. (rc = 40) 
IEVCMSO74E ERROR action AUXILIARY DIRECTORY. (rc = 40) 


IEVCHSO36% is issued if a user FILEDEF SYSIN DISK fn... i158 
active, a tilename is specified in the HASM command, but the two 
filenames do not match. 


ITEVCHSO7J4E is issaed if an error occurs SETTING or RESETTING the 
auxiliary directory (insertion/deletion from the FST chain). 


5-3 OVERRIDING HASS FILE DEPAULTS 


When you issue the HASM command, there are default FILEDEF 
commands issued for assembler datasets. You may wish to override 
these with explicit FILEDEF commands. The ddnames used are: 


SYSIN —- input to the assembler 
SYSLIB ~ macro/COPY library 


SYSUT1 - utility work file 

SYSPUNCH ~— object aodule output 

SYSLIN - object module output 

SYSPRINT -— listing output 

SYSTERS -— diagnostic output (SYSTERM applies 
to CMS environment only) 


Tne defauit FILEDEFP commands issued by HASM for these ddnames 
are: 


PILEDEF SYSIN DISK fin ASSEMBLE * (RECPR FE LRECL &0 BLOCK 3200 
FILEDEF SYSLIB DISK CMSLIB MACLIB * (KECFM FB LRECL 80 BLOCK 3200 
FILEDEP SYSUT1 DISK fn SYSUT1 2&4 (BLOCK 4000 

FIL&LEFP SYSPUNCE PUNCH 

FILEDEF SYSLIN DISK fn TEXT ml | 

FiLEDEF SYSPRINT DISK fn LISTING nal (RECFS FB BLOCK 121 

FILEDEF SYSTERM TERMINAL 


in the ftiledets for SYSUI7, SYSLIN, and SYSPRINT, the filemodes 
'aG* and ‘“"mi® are established dynamically by the HASM command 
processor as tollows: 

in the faledet for SYSUT1T, the filemode ‘m4* is set to use the 
read/write disk with the nost available space. For exaraple, if 


em 


three read/write disks were accessed as the A, t, and D disks, if 
the D disk had the sost available space then ‘m4&* would be set to 
*pD4* tor use during the assembly. 


In the tiledets tor SY¥YSLIN and SYSPRINT, if the assembler source 
file (SYSiN input) is NOT on disk or iS on a read/oniy disk, the 
filemode "nT* as set to "AT®. If the source tile is on a 
read/write disk, the mode Letter ‘m*® is set to the moae of that 
read/fwrate dask. For example, if the source tile were on a 
read/write EK disk, the filemode "m1" would be set to "il". 


A FILEDEF command, issued for any of the above ddnames prior to 
imvox ing the assembier, overrides the default FILEVEF issued by 
the HAS& command processur. Assumue that there is an assembler 
source tile in Cara deck form whica you wish to assemble. If you 
have this card deck available to your CMS card reader, you could 
issue an overriding FILEDEF command prior to assembiiny, that is, 
FIL#DiEF SYSIN KEADER. sow you can invoke the assembler as 
tollows: 


HASN SAMBPLE (options .. . 


The name SASPLE is used by HASM as the filename tor any WEXT or 
LISTING file produced by the assembler. An existing TEXT or 
LISTING file on your read/write A-disk would be erased by the 
HaS4 coamand processor. 





Similariy, if you have a tape containing an assembier input file 
which you wisn to assemble, you could issue the following 
cohma Gds: 


PILEVEF SYSIN TAFn (KECFS F LRECL 80 BLOCK &U 


or, if the tile were blocked o40x800, you coulc Specify BLOCK &00 
in the preceding FILEDEFP. In either case, the FILEDEF would be 
followed by the Command EASM SAMPLE (options ... 


You Cun read OS datasets as CaS files by defining those datasets 
with the FILEUEF command. For example: 


FILEVEF SYSIN DIS# OSDUS ASSEMBLE fm 
DSN OS DATASET (options ... 
HASM (options . . e | 


It as also possible to assemble a member of an OS PDS by uSing 
the MEMEEBK paraweter of the PILEDEF command. 


Tae sage technigues used in these examples can be applied to 
Other ddnames. Care should be taken that any attributes 
Specified for a file conform to the assembler expected attributes 
for the device. 


The OYSTERS DbCb specifies REC PSH=PA ,LRECL=121,8LKSIZE=121. 
Information concerning the attributes used for other assembler 
tiles can be found in the publication OS Assembler 4 Programmer's 
Guide, Order No. S8C26-3759. : 
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One ot the tiles loaded a the installation disx when. KAS4% 1s 
installed is named IEVSAM! ASSEMBLE. This tile nay py used as 
input to the asSeabier to test the correctness ot the 
installation procedure. with the installation disk aCCkESSeud as 
the Cead/wrate A-dask, issue the commands 


HASS LTEVSAMP (options you choose .. . 
€.G. HASM LEVSAMP (PRINT XKEF (SHORT) ) 


Lf your assembiy resuits in the creation ot iEVSASP TEXT and/or 
LEVSAMP LISTING on the anstallation disk, you may wigh to ERASE 
these two files after you have completea your vaiidation 
proceuures. 


For a more complete discussion of the sample program, and tor 
intorwation on the results expected from an assembly oi the 
Sample program, cefer to Appendix A of the publication OS 
Assembier H Programmer*®s Guide, Order No. SC26-3759. 
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7.0 MNODIFICATION AIDS 


Modules ITEVCSS ans IEVAUX are of fixed size in the sense that 
each module contains unused space at its end. This is 
accomplished by using an ORG statement (in the ASSEMBLE file) at 
the end of each of these podules. IEVCMS module size is xX*®1C00°* 
bytes, and IEVAUX moduie size is X*400" bytes. The unused space 
is provided so that code gay be added to or deleted from either 
module without affecting the overall size of HASM MODULE. This 
means that HASS MODULE may be re-—generated without affecting the 
load points of the Assembler H smolules. | 
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